package com.hifar.test.api.service;

import com.hifar.test.api.model.DataRequest;
import com.hifar.test.api.model.DataResponse;

/**
 * 数据接收端服务接口
 * 作为数据资产管理平台，处理接收到的数据
 * 
 * @author system
 * @since 1.0.0
 */
public interface DataReceiverService {
    
    /**
     * 处理组织信息数据
     * 
     * @param dataRequest 数据请求
     * @param clientIp 客户端IP
     * @return 处理结果
     */
    DataResponse processOrganizationData(DataRequest dataRequest, String clientIp);
    
    /**
     * 处理员工数据
     * 
     * @param dataRequest 数据请求
     * @param clientIp 客户端IP
     * @return 处理结果
     */
    DataResponse processEmployeeData(DataRequest dataRequest, String clientIp);
    
    /**
     * 处理通用数据
     * 
     * @param dataRequest 数据请求
     * @param clientIp 客户端IP
     * @return 处理结果
     */
    DataResponse processData(DataRequest dataRequest, String clientIp);
    
    /**
     * 验证数据格式
     * 
     * @param dataRequest 数据请求
     * @return 是否有效
     */
    boolean validateData(DataRequest dataRequest);
    
    /**
     * 保存数据到数据库
     * 
     * @param dataRequest 数据请求
     * @return 是否保存成功
     */
    boolean saveData(DataRequest dataRequest);
    
    /**
     * 获取处理统计信息
     * 
     * @return 统计信息
     */
    String getProcessingStats();
}